package com.papers.juan.service;

import com.papers.common.core.domain.PageQuery;
import com.papers.common.core.page.TableDataInfo;
import com.papers.juan.domain.TJuanPaper;
import com.papers.juan.domain.bean.PaperDetailBean;
import com.papers.juan.domain.bean.PaperImportBean;
import com.papers.juan.domain.bean.PaperStatisticsBean;
import com.papers.juan.domain.bean.RandomTakeOutPaperBean;
import com.papers.juan.domain.bo.TJuanPaperBo;
import com.papers.juan.domain.vo.TJuanPaperVo;
import org.springframework.web.multipart.MultipartFile;

import javax.servlet.http.HttpServletResponse;
import java.util.Collection;
import java.util.List;

/**
 * 试卷Service接口
 *
 * @author papers
 * @date 2022-10-08
 */
public interface ITJuanPaperService {

    /**
     * 查询试卷
     */
    TJuanPaperVo queryById(String paperId);

    /**
     * 查询试卷列表
     */
    TableDataInfo<TJuanPaperVo> queryPageList(TJuanPaperBo bo, PageQuery pageQuery);

    /**
     * 查询试卷列表
     */
    List<TJuanPaperVo> queryList(TJuanPaperBo bo);

    /**
     * 新增试卷
     *
     * @param juanPaperBo 试卷信息
     */
    Boolean insertByBo(TJuanPaperBo juanPaperBo);

    /**
     * 修改试卷
     */
    Boolean updateByBo(TJuanPaperBo bo);

    /**
     * 校验并批量删除试卷信息
     */
    Boolean deleteWithValidByIds(Collection<String> ids, Boolean isValid);

    /**
     * 导入试卷
     *
     * @param paperImportBeans 试卷导入信息
     */
    void importData(List<PaperImportBean> paperImportBeans);

    /**
     * 根据试卷id获取试卷详情
     *
     * @param paperId 试卷id
     * @return 试卷详情
     */
    PaperDetailBean queryPaperDetailById(String paperId);

    /**
     * 根据试卷id列表获取试卷名称列表
     *
     * @param ids 试卷id列表
     * @return 试卷名称列表
     */
    List<String> queryPaperNamesByIds(List<String> ids);

    /**
     * 根据课程id随机抽卷
     *
     * @param bean 随机抽取试卷bean
     * @return 试卷列表
     */
    List<TJuanPaper> randomTakeOutPaper(RandomTakeOutPaperBean bean);

    /**
     * 根据试卷id获取试卷统计数据
     *
     * @param paperId 试卷id
     * @return 试卷统计数据
     */
    PaperStatisticsBean queryPaperStatisticsById(String paperId);

    /**
     * 导出试卷json信息
     *
     * @param paperId  试卷id
     * @param response 响应
     */
    void exportPaperJson(String paperId, HttpServletResponse response);

    /**
     * 导入试卷json信息
     *
     * @param file 试卷json文件
     */
    void importPaperJson(MultipartFile file);

}
